home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / misc / avmnfaxsrc1_33.lha / EFAX.README < prev    next >
Text File  |  1994-06-03  |  3KB  |  77 lines
  1.               Introduction
  2.  
  3. This is the README file for version 0.6a of efax, a program to
  4. send and receive faxes using any Class 1 or Class 2 fax modem.
  5.  
  6. efax is a relatively small ANSI C/POSIX program that provides the
  7. data transport function for fax applications.  A simple shell
  8. script (``fax'') is included in the distribution to let you
  9. create, send, receive and print faxes.
  10.  
  11. efax is smaller and easier to install than FlexFax, NetFax, or
  12. mgetty+sendfax.  It uses your system's own getty to handle
  13. incoming data calls. As one user put it, ``EFAX is a nice simple
  14. program for single user systems.''
  15.  
  16. In addition to efax you'll need Ghostscript (I used version
  17. 2.6.1), to create the fax image files and the PBMPlus utilities
  18. to convert the received fax to a format that you can print.
  19.  
  20. This version of the program was written & tested under Linux.
  21. Previous versions have been compiled and used under AIX 3.2.4,
  22. BSD, IRIX 5.2, NeXT, OSF/1V1.3, SunOS 4.1.1/4.1.3, SCO 3.2.0,
  23. SysVR4.2, and ULTRIX and should work with minor changes on any
  24. modern UNIX with an ANSI C compiler/library and a termios(4)
  25. serial device interface.
  26.  
  27. efax is distributed as a gzip'ed tar file, efax06a.tar.gz.  It
  28. may be obtained by anonymous FTP from sunsite.unc.edu in
  29. /pub/Linux/Incoming or /pub/Linux/apps/comm.
  30.  
  31.     Changes to efax from version 0.6 to version 0.6a
  32.  
  33. - correctly receives faxes with mixed format pages (Class 1)
  34.  
  35. - correctly handles failure to create lock file
  36.  
  37. - warns about non-standard characters in local ID
  38.  
  39. - fax script has option for A4 text pages
  40.  
  41. - various other bug fixes
  42.  
  43.                 Manifest
  44.  
  45. The efax distribution should contain the following files:
  46.  
  47. README   - this file
  48. COPYING  - the GNU public license
  49. efax.c   - the source code
  50. efax.1   - a man page for efax(1)
  51. fax      - a Bourne shell script to create, send, receive and
  52.            print faxes.  Requires Ghostscript and PBMPlus
  53.            utilities.
  54. fax.1    - man page for fax(1)
  55.  
  56.               Installation
  57.  
  58. You'll need an ANSI C compiler, such as gcc, to compile the code.
  59. With gcc, do:
  60.  
  61.   gcc -o efax -O efax.c 
  62.  
  63. Modify the variables at the beginning of the `fax' shell script
  64. according to the comments. Copy the executable, script, and man
  65. pages to appropriate directories (probably /usr/bin and
  66. /usr/man/man1).  
  67.  
  68. The efax(1) man page has information on resolving problems and
  69. describes how to modify /etc/inittab (SysV) or /etc/ttytab (BSD)
  70. so efax can handle incoming fax and data calls automatically.
  71.  
  72.                Bug Reports
  73.  
  74. Please send bug reports or suggestions to edc@ee.ubc.ca.  Please
  75. include a copy of the session log and details about the modem and
  76. operating system you are using.
  77.